<?php

namespace Illuminate\View\Engines;

use Exception;
use Illuminate\Contracts\View\Engine;
use Symfony\Component\Debug\Exception\FatalThrowableError;
use Throwable;

/**
 * PHP 文件解析引擎
 */
class PhpEngine implements Engine
{
    /**
     * 获取视图的评估内容
     *
     * @param  string $path
     * @param  array $data
     * @return string
     */
    public function get($path, array $data = [])
    {
        return $this->evaluatePath($path, $data);
    }

    /**
     * 获取指定视图的求值内容
     *
     * @param  string $__path 文件路径
     * @param  array $__data 配置项
     * @return string
     */
    protected function evaluatePath($__path, $__data)
    {
        $obLevel = ob_get_level();

        // 此函数将打开输出缓冲。当输出缓冲激活后，脚本将不会输出内容（除http标头外），
        // 相反需要输出的内容被存储在内部缓冲区中。
        ob_start();

        extract($__data, EXTR_SKIP);    // 如果有冲突，不覆盖已有的变量。

        // 我们将在 try/catch 块中计算视图的内容，这样我们就可以在错误发生或抛出异常
        // 之前清除任何可能出现的输出，这可以防止任何部分视图泄漏。
        try {
            include $__path;
        } catch (Exception $e) {
            $this->handleViewException($e, $obLevel);
        } catch (Throwable $e) {
            $this->handleViewException(new FatalThrowableError($e), $obLevel);
        }

        return ltrim(ob_get_clean());   // 得到当前缓冲区的内容并删除当前输出缓冲区。
    }

    /**
     * 处理一个视图异常
     *
     * @param  \Exception $e
     * @param  int $obLevel
     * @return void
     *
     * @throws \Exception
     */
    protected function handleViewException(Exception $e, $obLevel)
    {
        while (ob_get_level() > $obLevel) {
            ob_end_clean();
        }

        throw $e;
    }
}
